home *** CD-ROM | disk | FTP | other *** search
/ Mac Action 1996 January / mac-action-07.iso / mac / Sound ’n’ Vision / CD Coyote 2.11 / CD Coyote 2.1.1 Readme next >
Encoding:
Text File  |  1995-03-06  |  18.0 KB  |  458 lines  |  [TEXT/R*ch]
  1. CD COYOTE 2.1.1 README
  2.  
  3. <There is a HTML version of this Readme at 
  4. http://www.uta.fi/~eesau/macintosh.html>
  5.  
  6. See 'Version history' at the end of this document to find out what's new
  7. in this version.
  8.  
  9. CD Coyote is a program for CD-ROM drive users who listen to audio CD's and
  10. have written disc information to CD Remote DA or AppleCD Audio Player.  With
  11. CD Coyote You can edit the information saved with the CD player.  You can:
  12.  
  13. - Edit all disc information without inserting the CD to the CD-ROM drive.
  14. - Save the disc informatin to a TEXT file with user defineable options.
  15. - Merge many 'CD Remote Programs' files to just one so You can share 'CD
  16.   Remote Programs' files with Your friends.
  17. - Add discs to the 'CD Remote Programs' database.  Audio CD must be inserted
  18.   (if it is not there allready) to the CD-ROM drive to get the identification
  19.   number from the disc.
  20. - Remove discs from the database.
  21. - Sort discs alhabetically in the database.
  22.  
  23. Additional features:
  24.  
  25. - Find and Find Again commands to search for a text string in the database.
  26. - Control the CD-ROM drive.  Includes play, pause, continue, skip to previous
  27.   or next track and stop playing of audio CD's.  Eject any CD in the CD-ROM
  28.   drive.
  29.  
  30. And hey! CD Coyote is still FREE!
  31.  
  32. SYSTEM REQUIREMENTS
  33.  
  34. CD Coyote needs System 7 or later to run.  When launched it checks if System
  35. 7 is present and if not it displays an error message and quits.
  36. You also need to have CD Remote or AppleCD Audio Player (or to be precise the
  37. 'CD Remote Programs' file) to get the information to edit.
  38. Some features require Apple compatible CD-ROM drive.
  39.  
  40. HOW TO USE?
  41.  
  42. CD Coyote has full Balloon Help.  To learn how to use it just turn on Balloon
  43. Help and start using it.  However here is a description of the program.
  44.  
  45. When You launch CD Coyote it tries to find 'CD Remote Programs' file from
  46. the Preferences folder.  If it finds it You are ready to use CD Coyote.  If
  47. it doesn't find the 'CD Remote Programs' file You have to open one with the
  48. Open... command in the file menu.  You may also drag-and-drop any 'CD Remote
  49. Programs' file to the CD Coyote icon and CD Coyote will use that file. 
  50. Current 'CD Remote Programs' file is displayed in the top  of window and if
  51. none is set it displays text 'File not found in the Preferences folder'.
  52.  
  53. CD COYOTE WINDOW
  54.  
  55. The window is divided into four areas:
  56.  
  57. On the top of the window there is two rows of text.  First says 'Current 'CD
  58. Remote Programs' file:' and the second is the path to that file.  If no file
  59. is set or found the second line says 'File not found in the Preferences
  60. folder'.
  61.  
  62. Next is the Disc list.  Over the list is displayed the total number
  63. of discs in the database. If the database is empty but readable then text
  64. 'current 'CD Remote Programs' file is empty' is displayed.  On the right of
  65. the list is scrollbar that You can scroll other discs to sight.  Currently
  66. selected disc has its number boldfaced.
  67.  
  68. Under the disc list is the track list.  Over the list is displayed how many
  69. tracks is on the currently selected disc and also the total number of tracks
  70. on all discs.  On the right there is again a scrollbar to scroll other tracks
  71. to sight.
  72.  
  73. Between the two lists just above the track counts there is two horizontal
  74. lines.  When the cursor is between these lines You will notice that the
  75. cursor changes to up and down pointing arrows.  If You hold the mouse button
  76. down between these lines and drag up or down You can resize the two lists. 
  77. Minimum size of a list is four items and CD Coyote woun't allow You to make a
  78. list smaller than that.
  79.  
  80. In the bottom of window there is a row of text that gives You some CD-ROM
  81. drive status information.
  82.  
  83. The window can be resized from the grow icon in the bottom right corner of
  84. the window.  Clicking the zoom button in the window's titlebar will resize
  85. the window to fit on the monitor that has most of the window in it.  You can
  86. move the window anywhere on screen from the titlebar.  Also there is a
  87. closebox which when clicked quits CD Coyote.
  88.  
  89. CD Coyote remembers the window position and size of the window when You quit
  90. and uses those next time You use CD Coyote.
  91.  
  92. EDITING THE INFO IN THE DATABASE
  93.  
  94. NOTE!  Unlike in the previous version of CD Coyote it is now more safe to
  95. edit the disc info.  That is because CD Coyote now creates a temporary copy
  96. of the file You opened and makes all changes to that file.  Changes to the
  97. original file are saved only when You choose Save from the file menu (or if
  98. You answer OK when it is asked if You want to save changes).
  99.  
  100. To edit disc or track name just click on it and a black frame is drawn around
  101. it and the text is selected and editable.  When editing the normal text edit
  102. functions in the Edit menu are usable.  If You press tab or return keys when
  103. disc is currently selected then the first track in the tracklist is selected.
  104. Always when a track is selected and tab or return is pressed the next track
  105. is selected.  If the last track is selected and tab or return is pressed the
  106. disc title is selected.  If You hold down the shift key when pressing tab or
  107. return then the previous track (or the disc name if the first track is the
  108. current edit field) will be selected.
  109.  
  110. Holding option key down when pressing tab or return will select the next disc
  111. in the disc list.  If You hold down the shift key when pressing option-tab or
  112. option-return then the previous disc is selected.
  113. NOTE! If You are using some extension that patches option-tab to some other
  114. action (like Option-Tab Program Switcher by Michael F. Kamprath) You have to
  115. use option-return to select the next disc.
  116.  
  117. When editing the text in field You are able to type only 62 characters.  This
  118. limitation is there because this is how AppleCD Audio Player works.  I have
  119. no idea why.  Also when Pasteing text to a field if it will be more than 62
  120. characters the text will not be pasted.  If the text to be pasted includes
  121. returns they are converted to spaces.
  122.  
  123. ADDING A DISC TO THE DATABASE
  124.  
  125. To add an audio disc to the database choose Add Disc command from the Edit
  126. menu.  If there is a disc allready in the CD-ROM drive CD Coyote tries to add
  127. that disc to the database.  If there is no disc in the CD-ROM drive then CD
  128. Coyote asks You to insert one to the CD-ROM drive and waits for the disc.
  129. If the disc to be added is allready in the database or it has no audio tracks
  130. then an error message is displayed and the disc is not added.
  131.  
  132. REMOVING A DISC FROM THE DATABASE
  133.  
  134. To remove a disc from the database choose Remove Disc from the Edit menu.
  135. The disc to be removed is the current disc in the disc list (i.e. the one
  136. with the boldfaced number).  CD Coyote asks if You really want to remove the
  137. disc and if You answer OK the disc will be removed.
  138.  
  139. MENUS AND WHAT THEY DO
  140.  
  141. Apple menu
  142.     About CD Coyote...    Displays an about dialog.
  143.  
  144. File menu
  145.     Open...                Open another 'CD Remote Programs' file.
  146.  
  147.     Close                Quits CD Coyote.  Same as clicking the windows
  148.                         close box.
  149.  
  150.     Save                Saves the changes made to the 'CD Remote Programs'
  151.                         file.
  152.  
  153.     Save As...            Saves a copy of the 'CD Remote Programs' file.
  154.     
  155.     Save As TEXT...        Saves disc info to the disk as a TEXT file.  All
  156.                         options from 'Saving List...' dialog are used.
  157.  
  158.     Merge File...        Merges another 'CD Remote Programs' file to
  159.                         currently open file.  Options from 'Merging Files...'
  160.                         dialog are used.
  161.  
  162.     Quit                Quits CD Coyote.  Same as clicking the windows
  163.                         close box.
  164.  
  165. Edit menu
  166.     Undo                Undoes the last action if it is undoable. Undoable
  167.                         actions are text editing within one field.
  168.  
  169.     Cut                    Normal text editing functions.
  170.     Copy
  171.     Paste
  172.     Clear
  173.  
  174.     Select All            Selects the text in the currently active text
  175.                         editing field.
  176.  
  177.     Add Disc            Adds a disc to the currently open 'CD Remote
  178.                         Programs' file.
  179.  
  180.     Remove Disc            Removes current disc from the currently open 'CD
  181.                         Remote Programs' file.
  182.  
  183.     Preferences            Has submenu with two commands: Saving List... and
  184.                         Merging Files... which both open an preferences
  185.                         dialog.  See descriptions of the dialogs below.
  186.  
  187. Special menu
  188.     Sort Discs            Sorts the discs in the database alphabetically.
  189.  
  190.     Find...                Brings up a dialog where You can type search
  191.                         string and set search options.  See description
  192.                         below.
  193.  
  194.     Find Again            Repeat the search with the previously entered
  195.                         search string.
  196.  
  197.     CD Control            Has submenu that has CD controlling commands.
  198.  
  199. CD Control submenu
  200.     Play/Pause/Continue    Plays (or continues if paused) playing of audio
  201.                         CD.  Pauses if allready playing.  The title of the
  202.                         command tells the actual action that takes place when
  203.                         selected.
  204.  
  205.     Previous Track        Skips to the previous track.
  206.  
  207.     Next Track            Skips to the next track.
  208.  
  209.     Stop                Stops playing of audio CD.
  210.  
  211.     Eject                Ejects a CD from the CD-ROM drive.
  212.  
  213. SAVING LIST PREFERENCES DIALOG
  214.  
  215. CD Coyote allows You to set various options that affect the information and
  216. layout of the output file when Save As TEXT is selected in the File menu.
  217. Options are set by clicking appropriate buttons. Options and their meanings
  218. are:
  219.  
  220. Option                Meaning
  221.  
  222. Get CD Titles        If this option is checked CD Coyote will get the CD
  223.                     titles.  If not checked, the titles are omitted.
  224.  
  225. Number Titles        If this option is checked CD Coyote will number the CD
  226.                     titles.  If not checked, the titles are not numbered.  If
  227.                     You didn't check the Get CD Titles this has no effect.
  228.  
  229. Get Track Names        If this option is checked CD Coyote will get the track
  230.                     names.  If not checked, the tracks are omitted.
  231.  
  232. Number Titles        If this option is checked CD Coyote will number the
  233.                     track names.  If not checked, the tracks are not
  234.                     numbered.  If You didn't check the Get Track Names this 
  235.                     has no effect.
  236.  
  237. Delimiter:
  238.  
  239. Between Each Disc    This option lets You choose whether to put a tab,
  240.                     return or some other mark between each discs' info.
  241.                     See more about this at chapter 'Special note about the
  242.                     Other Delimiter field'.
  243.  
  244. Before Track List    Same as Disc Delimiter only now between disc title and
  245.                     the tracks.  See more about this at chapter 'Importing
  246.                     disc list to a database or a spreadsheet program'.
  247.  
  248. Between Each Track     Same as Disc Delimiter only now between tracks.
  249.  
  250. Empty Line Between Discs    If this option is checked CD Coyote will add
  251.                             an empty line after each disc.
  252.  
  253. Empty Line After Disc Title    If this option is checked CD Coyote will add
  254.                             an empty line after disc title.  Note that if
  255.                             You are only saving the disc titles and have
  256.                             both Empty Line Between Discs and Empty Line
  257.                             After Disc Title checked You will get two
  258.                             empty lines between the titles.
  259.  
  260. TEXT File Creator    Allows You to specify creator for the output file.
  261.                     You can either select one from the popup menu or
  262.                     write one by yourself to the field.  If You write
  263.                     one it will be added to the popup menu.  Note that
  264.                     only the first four characters of the field are used
  265.                     as a creator.  If You write less than four characters
  266.                     ?'s are added to the creator to get four characters.
  267.                     Predefined creators in the popup menu are:
  268.                     R*ch - BBEdit
  269.                     ttxt - TeachText
  270.                     WORD - MacWrite
  271.                     MWII - MacWrite II
  272.                     MSWD - MicroSoft Word
  273.  
  274. SPECIAL NOTE ABOUT THE OTHER DELIMITER FIELD
  275.  
  276. If Other is selected CD Coyote will parse the field as follows:
  277. If the first character in the field is ^ then any numbers after it are read
  278. as decimal numbers and used as a ASCII value.  For example: ^65 means ASCII
  279. 65 which is A.
  280. If the first character in the field is $ then any hexadecimal numbers after
  281. it are read as hexadecimal numbers and used as a ASCII value.  For example: 
  282. $4A means ASCII 74 which is J.
  283.  
  284. IMPORTING DISC LIST TO A DATABASE OR A SPREADSHEET PROGRAM
  285.  
  286. If You are using CD Coyote to save list of the discs and want to import
  287. that list to a database or a sreadsheet program there are a couple of
  288. things You should know.  Use return as delimiter between each disc and tab
  289. before track list and between aech track.  Both empty line between discs and
  290. titles should be unchecked.  When these options are in effect and You save
  291. the output file You can import it to most database or sreadsheet programs as
  292. tabulated text.  When You import the file set the record delimiter to return
  293. and field delimiter to tab.
  294.  
  295. FileMaker Pro users can use the Other field to make tracks an repeating
  296. field.  Use return as delimiter between each disc and tab before track list.
  297. Between each track choose Other and write to the other field '^29' or '$1D'
  298. (without quotes).  This is the value that FileMaker Pro uses as a delimiter
  299. between its repeating fields.  When You import the saved list to FM Pro
  300. first make a repeating field and when importing put the tracks go to that
  301. field.
  302.  
  303. MERGING FILES PREFERENCES DIALOG
  304.  
  305. This dialog has only three radio buttons that affect the way CD Coyote
  306. behaves when a disc found in the file to be merged is allready in the
  307. database.
  308.  
  309. If 'Never replace' is choosed CD Coyote ignores the disc in the new file
  310. and leaves the original in the database.
  311. If 'Confirm before replacing' is choosed CD Coyote asks if the disc should
  312. be replaced or not.
  313. If 'Replace without confirming' is choosed CD Coyote will replace the disc
  314. without asking if it shoud replace it.
  315.  
  316. FIND DIALOG
  317.  
  318. With this dialog You can set the search options and also start searching.
  319. The window has following options:
  320.  
  321. Search for:        Type here the string You want to search.
  322.  
  323. Match Case        If this option is checked the search is made case
  324.                 sensitive.
  325.  
  326. Search Tracks    If this option is checked the search will be done in the
  327.                 tracks and in the disc titles.  The first disc title is
  328.                 searched first and after that the tracks are searched.
  329.                 After the tracks are searched the search continues to the
  330.                 next disc title and that disc's tracks and so on.
  331.  
  332. Cancel            Closes the dialog without starting the search.  Leaves all
  333.                 the options in effect including the search string.
  334.  
  335. Find            Starts the search.
  336.  
  337. WHY THE NAME CD COYOTE?
  338.  
  339. Someone asks this anyway so here it is  :-)
  340. I happen to be a great fan of Wile E. Coyote and this is a tribute to him.
  341.  
  342. THANKS TO
  343.  
  344. - Kätsä Lähteenaho for the Icons and the Wile picture in the About box.
  345. - Matthew Xavier Mora for the PathNameFromFSSpec function.
  346. - My kids Tytti and Aleksanteri who love to watch cartoons with me.
  347. - Wile E. Coyote - The Greatest Genius In History.
  348. - Heini for being there.
  349. - jong15@aol.com & Michael Whitney <michael_whitney@qm.claris.com> for
  350.   telling me about FileMaker Pro's repeating fields.
  351. - Peter N Lewis <peter.lewis@info.curtin.edu.au> for his STR# editing
  352.   routines and dialog routines.
  353. - All the people who sent me comments, suggestions and bug reports.
  354.  
  355. DISCLAIMER
  356.  
  357. Use at Your own risk.  I don't take any responsibility of the damages
  358. CD Coyote may cause.  It hasn't caused any as far as I know.
  359.  
  360. REDISTRIBUTION
  361.  
  362. CD Coyote copyright © 1993-1995 by Esa Ristilä.
  363. CD Coyote is distributed FREE of all charges.  Distribute unmodified
  364. copies freely as long as this Readme file is included in the package and
  365. no money is charged.
  366. If You wish to include CD Coyote on a commercial CD-ROM, BBS or other package
  367. ask for a written permission.  You are very likely to get it.
  368.  
  369. CONTACTING THE AUTHOR
  370.  
  371. Bugreports, donations and postcards most welcome  :-)
  372.  
  373. Postcards:    Esa Ristilä
  374.             Ratakatu 11 as. 11
  375.             33250 TAMPERE
  376.             FINLAND
  377.  
  378. Email:        eesau@uta.fi
  379.  
  380. WWW:        http://www.uta.fi/~eesau/
  381.  
  382. IRC:        eesau
  383.  
  384. VERSION HISTORY
  385.  
  386. CD Coyote 2.1.1 - 6th of March 1995
  387.  
  388.     - Fixed a bug that caused track names to get messed up in some
  389.       situations.
  390.     - Command-D in the Save changes dialog is the same as clicking Don't save
  391.       with the mouse.
  392.     - Made forward delete to work.
  393.     - Function keys F1-F4 operates as Undo, Cut, Copy, and Paste.
  394.  
  395. CD Coyote 2.1 - 16th of Janyary 1995
  396.  
  397.     - Ability to add discs to the 'CD Remote Programs' database.  Audio CD
  398.       must be inserted (if it is not there allready) to the CD-ROM drive to
  399.       get the identification number from the disc.
  400.     - Ability to remove discs from the database.
  401.     - Ability to sort discs alhabetically in the database.
  402.     - Find and Find Again commands to search for a text string in the
  403.       database.
  404.     - More safe file handling. Doesn't edit original 'CD Remote Programs'
  405.       file directly anymore.
  406.     - Save and Save As commands to save current 'CD Remote Programs' file.
  407.     - Ability to play, pause, continue and stop playing of audio CD's.  Eject
  408.       any CD in the CD-ROM drive.
  409.     - Resizeable window and disc list and track lists.
  410.     - Removed Set button from the window and replaced it with Open command
  411.       in the File menu.
  412.     - Truncation of the current file path is done in the middle of the
  413.       string.
  414.     - Option-Tab or Option-Return selects the next disc in the disc list. 
  415.       Option-Shift-Tab and Option-Shift-Return selects the previous disc in
  416.       the disc list.
  417.     - Removed the searching of the 'CD Remote Programs' file from the System
  418.       folder.  Why?  Because the file should be in the Preferences folder in
  419.       System 7 and later.
  420.     - Some minor bug fixes.
  421.  
  422. CD Coyote 2.0.1 - 21st of November 1994
  423.  
  424.     BugFix release, fixed bugs are:
  425.     
  426.     - If there was zero sized 'CD Remote Programs' file in the preferences
  427.       folder CD Coyote crashed when trying to open it at launch. Now displays
  428.       message that the file can't be used.
  429.     - On b/w only machines CD Coyote tried to open color window and crashed.
  430.       Now it checks if machine is b/w only.
  431.     - On 9" screens windows titlebar was under the menubar.
  432.     - Drag and dropping an empty 'CD Remote Programs' file doesn't leave
  433.       first disc in the last file visible any more.
  434.     - Drag and dropping now always selects first disc if file wasn't empty.
  435.     - Other minor changes (did those error checkings finally).  :-)
  436.  
  437.  
  438. CD Coyote 2.0 - 25th of October 1994
  439.  
  440.     - Ability to edit all disc titles and track names without inserting the
  441.       CD to the CD-ROM drive.
  442.     - Ability to merge many 'CD Remote Programs' files to one.
  443.     - New user interface.
  444.     - Saving list to a TEXT file has new option.  It is now possible to use
  445.       any character as delimiter between the fields.
  446.  
  447. CD Coyote 1.0.1 - 12th of October 1993
  448.  
  449.     - Added to look for 'CD Remote Programs' file from System folder too.  
  450.       The assumption that the file is always in the Preferences folder
  451.       occurred to be fairly stupid.
  452.     - Removed the automatic save when 'CD Remote Programs' file was
  453.       drag-and-dropped to CD Coyote.
  454.     
  455. CD Coyote 1.0 - 7th of October 1993
  456.  
  457.     - First release
  458.